home *** CD-ROM | disk | FTP | other *** search
/ PC-Blue - MS DOS Public Domain Library / PC-Blue MS-DOS Public Domain Library - NYACC.iso / vol356 / gemcap.arc / GEMCAP.DOC < prev   
Encoding:
Text File  |  1987-08-26  |  5.9 KB  |  145 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                                   Natural Software
  8.                                 19 South 5th. Street
  9.                              St. Charles, Illinois 60174
  10.                                    (312) 377-7320
  11.  
  12.  
  13.         This share-ware  utility program:  GEMCAP.COM, allows  you to capture
  14.         screen images  from other  programs, save  them in  separate GEM .IMG
  15.         files, and  later load  them into  other programs  that can read this
  16.         format such as Ventura Publisher. 
  17.  
  18.         GEMCAP is a Terminate and Stay Resident (TSR)  program. When  you run
  19.         it  from  the  DOS  command  line,  it will announce its presence and
  20.         quietly sink into the background and  wait to  be called  into action
  21.         (when  its  "hot  key"  is  pressed).  When  you run GEMCAP, you must
  22.         provide it with the location and starting file  name to  use to store
  23.         the screen  images it  captures. For  example, you might start GEMCAP
  24.         with this command:
  25.  
  26.                     GEMCAP C:\SCREENS\SCREENA.IMG
  27.  
  28.         Now GEMCAP will store its screens  in the  SCREENS sub-directory. The
  29.         first screen  it saves will be called SCREENA.IMG, the second will be
  30.         called SCREENB.IMG. Each  subsequent  .IMG  file  will  increment the
  31.         character in  the filename just before the extension. These files are
  32.         graphic bit image files  compatible with  any program  that reads GEM
  33.         .IMG files,  regardless of  whether the  original screen  was in text
  34.         mode or graphics mode.
  35.  
  36.         To activate GEMCAP and save the  current screen  to a  .IMG file, you
  37.         press the [Alt + left Shift] keys together. You will hear a beep when
  38.         GEMCAP is  called. Three  beeps means  it successfully  wrote an .IMG
  39.         file to the specified directory. Only one beep means it was unable to
  40.         create the file (could not find the directory?). Only two beeps means
  41.         it created  the file, but could not write the full 16k screen buffer,
  42.         (disk full?).
  43.  
  44.         GEMCAP will  detect the  current video  mode and  adjust. It converts
  45.         text mode screens into bit mapped graphics.
  46.  
  47.         Like any other TSR, GEMCAP may have compatibility problems with other
  48.         software, especially other TSR's. If you have trouble, try installing
  49.         GEMCAP by  itself and  adding your  other TSR utilities one at a time
  50.         after you get GEMCAP to work.
  51.  
  52.         Removing GEMCAP:
  53.  
  54.         You can remove GEMCAP from memory (well, almost) by pressing the [Alt
  55.         + Right  Shift] key  combination. This  disengages GEMCAP  so that it
  56.         will not interfere with other software. This will  also release (most
  57.         of) the  memory used  by GEMCAP.  When loaded and active, GEMCAP uses
  58.         3856 bytes of memory. After removal  with [Alt  + Right  Shift], only
  59.         288 bytes remain allocated. It's probably a good idea to do this only
  60.         at the DOS command prompt!
  61.  
  62.  
  63.  
  64.  
  65.  
  66.         Different sized images:
  67.  
  68.         The size of the captured image is controlled by two words in the .IMG
  69.         file. These are constants  in  the  GEMCAP  program.  The  first word
  70.         specifies  the  pixel  size  in  width, the second word specifies the
  71.         pixel size in height  (unit of  measure is  in microns).  The default
  72.         values are: (in hexidecimal):
  73.  
  74.           Address        Value        
  75.           0108           00D5 (width), 
  76.           010A           01AA (heigth).
  77.  
  78.         To make  the displayed image one half the size of the default, change
  79.         these values to
  80.  
  81.  
  82.           Address        Value        
  83.           0108           006A (width), 
  84.           010A           00D5 (heigth).
  85.  
  86.         The steps using Debug to do this are: (you enter the stuff marked ^^)
  87.  
  88.                DEBUG XYZ.IMG                 (Load the image file)
  89.            ^^^^^^^^^^^^^
  90.                E 0108                        (enter data at address 0108)
  91.            ^^^^^^
  92.                XXXX:0108 00.00 D5.6A         (change  00D5   to  006A,  press
  93.                             ^^    ^^           space bar between entries)
  94.  
  95.                E 010A                        (do the same for address 010a)
  96.            ^^^^^^
  97.                XXXX:010A 01.00 AA.D5         (change 01AA to 00D5)
  98.                 ^^      ^^
  99.                W                             (write the changes to the file)
  100.            ^
  101.                Writing 4020 bytes
  102.  
  103.                Q                             (return to DOS)
  104.            ^
  105.         You can experiment with other values. However, some combinations will
  106.         cause truncations of pixels when the image is displayed.
  107.  
  108.         If you  find a  set of values that work for your application and wish
  109.         to make them the default values for all  captured images,  change the
  110.         corresponding values in the program (GEMCAP.COM) itself. These are at
  111.         address locations 0951 and 0953  (hex)  when  GEMCAP  is  loaded into
  112.         DEBUG.
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.         ShareWare:
  125.  
  126.         GEMCAP is  being distributed  as shareware. This means that it is not
  127.         free. This means that you must  pay to  use it.  However, you  do not
  128.         have to pay to try it, test it, and to determine if it is going to be
  129.         useful to you. You  are probably  familiar with  the concept  by now.
  130.         ShareWare programs give you the advantage of "test driving" them. The
  131.         advantage to the developer  is a  relatively inexpensive distribution
  132.         method.  For  this  concept  to  work and keep working for our mutual
  133.         advantage, you really must register  and  pay  for  the  software you
  134.         actually find useful.
  135.  
  136.         To register  your use  of GEMCAP,  send $20.00 to Natural Software at
  137.         the address above. We  will  send  you  a  description  of  our other
  138.         software offerings and provide telephone support. 
  139.  
  140.         If you  have suggestions for improvement, or problems please write or
  141.         call.
  142.  
  143.  
  144.  
  145.